home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / classq.z / classq
Text File  |  1996-03-14  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. CCCCLLLLAAAASSSSSSSSQQQQ((((3333FFFF))))                                                          CCCCLLLLAAAASSSSSSSSQQQQ((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CLASSQ - return the values scl and ssq such that   ( scl**2 )*ssq = x( 1
  10.      )**2 +...+ x( n )**2 + ( scale**2 )*sumsq,
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE CLASSQ( N, X, INCX, SCALE, SUMSQ )
  14.  
  15.          INTEGER        INCX, N
  16.  
  17.          REAL           SCALE, SUMSQ
  18.  
  19.          COMPLEX        X( * )
  20.  
  21. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  22.      CLASSQ returns the values scl and ssq such that
  23.  
  24.      where x( i ) = abs( X( 1 + ( i - 1 )*INCX ) ). The value of sumsq is
  25.      assumed to be at least unity and the value of ssq will then satisfy
  26.  
  27.         1.0 .le. ssq .le. ( sumsq + 2*n ).
  28.  
  29.      scale is assumed to be non-negative and scl returns the value
  30.  
  31.         scl = max( scale, abs( real( x( i ) ) ), abs( aimag( x( i ) ) ) ),
  32.                i
  33.  
  34.      scale and sumsq must be supplied in SCALE and SUMSQ respectively.  SCALE
  35.      and SUMSQ are overwritten by scl and ssq respectively.
  36.  
  37.      The routine makes only one pass through the vector X.
  38.  
  39.  
  40. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  41.      N       (input) INTEGER
  42.              The number of elements to be used from the vector X.
  43.  
  44.      X       (input) REAL
  45.              The vector x as described above.  x( i )  = X( 1 + ( i - 1 )*INCX
  46.              ), 1 <= i <= n.
  47.  
  48.      INCX    (input) INTEGER
  49.              The increment between successive values of the vector X.  INCX >
  50.              0.
  51.  
  52.      SCALE   (input/output) REAL
  53.              On entry, the value  scale  in the equation above.  On exit,
  54.              SCALE is overwritten with the value  scl .
  55.  
  56.      SUMSQ   (input/output) REAL
  57.              On entry, the value  sumsq  in the equation above.  On exit,
  58.              SUMSQ is overwritten with the value  ssq .
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.